package com.zenithmind.exam.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zenithmind.exam.pojo.entity.QuestionBank;

import java.util.List;

/**
 * 题库服务接口
 * 
 * @author ZenithMind
 * @since 2024-07-01
 */
public interface QuestionBankService extends IService<QuestionBank> {

    /**
     * 创建题库
     * 
     * @param questionBank 题库信息
     * @return 创建结果
     */
    boolean createQuestionBank(QuestionBank questionBank);

    /**
     * 更新题库
     * 
     * @param questionBank 题库信息
     * @return 更新结果
     */
    boolean updateQuestionBank(QuestionBank questionBank);

    /**
     * 删除题库
     * 
     * @param bankId 题库ID
     * @return 删除结果
     */
    boolean deleteQuestionBank(String bankId);

    /**
     * 根据ID获取题库
     * 
     * @param bankId 题库ID
     * @return 题库信息
     */
    QuestionBank getQuestionBankById(String bankId);

    /**
     * 根据分类ID获取题库列表
     * 
     * @param categoryId 分类ID
     * @return 题库列表
     */
    List<QuestionBank> getQuestionBanksByCategory(String categoryId);

    /**
     * 根据创建者ID获取题库列表
     * 
     * @param creatorId 创建者ID
     * @return 题库列表
     */
    List<QuestionBank> getQuestionBanksByCreator(String creatorId);

    /**
     * 获取公开题库列表
     * 
     * @return 公开题库列表
     */
    List<QuestionBank> getPublicQuestionBanks();

    /**
     * 分页查询题库列表
     * 
     * @param page 分页参数
     * @param title 题库标题
     * @param categoryId 分类ID
     * @param creatorId 创建者ID
     * @param status 状态
     * @param isPublic 是否公开
     * @return 分页结果
     */
    IPage<QuestionBank> getQuestionBankPage(Page<QuestionBank> page, String title, String categoryId, 
                                           String creatorId, Integer status, Integer isPublic);

    /**
     * 更新题库状态
     * 
     * @param bankId 题库ID
     * @param status 状态
     * @return 更新结果
     */
    boolean updateQuestionBankStatus(String bankId, Integer status);

    /**
     * 更新题库题目数量
     * 
     * @param bankId 题库ID
     * @return 更新结果
     */
    boolean updateQuestionCount(String bankId);

    /**
     * 根据标签获取题库列表
     * 
     * @param tag 标签
     * @return 题库列表
     */
    List<QuestionBank> getQuestionBanksByTag(String tag);

    /**
     * 获取热门题库列表
     * 
     * @param limit 限制数量
     * @return 热门题库列表
     */
    List<QuestionBank> getHotQuestionBanks(Integer limit);

    /**
     * 复制题库
     * 
     * @param bankId 题库ID
     * @param newTitle 新标题
     * @return 复制结果
     */
    boolean copyQuestionBank(String bankId, String newTitle);

    /**
     * 批量删除题库
     * 
     * @param bankIds 题库ID列表
     * @return 删除结果
     */
    boolean batchDeleteQuestionBanks(List<String> bankIds);

    /**
     * 检查题库是否可以删除
     * 
     * @param bankId 题库ID
     * @return 是否可以删除
     */
    boolean canDeleteQuestionBank(String bankId);

    /**
     * 统计用户创建的题库数量
     * 
     * @param creatorId 创建者ID
     * @return 题库数量
     */
    Integer countByCreator(String creatorId);
}
